home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / dos / pascal / datagen.exe / DG.DOC < prev    next >
Text File  |  1991-03-25  |  55KB  |  2,064 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.                                 The DataGen Kit
  27.                              USER REFERENCE MANUAL
  28.  
  29.                            Version 6.00 March 1991
  30.                       (C) Copyright 1989,90 by Tika Software.
  31.                               All Rights Reserved
  32.  
  33.                                  Tika Software
  34.                                 112 Village Path
  35.                                Lakewood, NJ 08701
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61. ────────────────────────────────────────────────────────────────────────────────
  62.  
  63.                                    DISCLAIMER
  64.  
  65.      Tika Software makes no representation or warranties with respect to
  66.      the contents hereof and specifically disclaims any implied warranties
  67.      to the suitability of this program for any particular purpose. You
  68.      must determine that yourself. In addition, you should understand that
  69.      using a program of this type on an IBM PC or compatible has inherent
  70.      risks and that you may inadvertently damage or destroy valuable pro-
  71.      grams or data. Tika Software expressly declines to assume liability
  72.      for any use of this program by you, and your use of this program con-
  73.      stitutes your agreement to hold us blameless. Tika Software reserves
  74.      the right to make changes from time to time in the context hereof
  75.      without obligation to notify any person or persons of such changes.
  76.  
  77.                                    TRADEMARK
  78.  
  79.      MS-DOS is a registered trademark of Microsoft Corporation.
  80.      PC-DOS is a registered trademark of IBM Corporation.
  81.      Turbo Pascal and Turbo Database Toolbox are registered trademarks of
  82.      Borland, Intl.
  83.      BTRIEVE is a registered trademark of SoftCraft, Inc.
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122. ────────────────────────────────────────────────────────────────────────────────
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                            DataGen Table of Contents
  131.  
  132.      Introduction.........................................................1
  133.      The DataGen Theory...................................................1
  134.      Why Use DataGen?.....................................................1
  135.      Mastering DataGen....................................................2
  136.      A Recipe for Instant DataGen Applications............................2
  137.      Explanation of Terms.................................................2
  138.  
  139.  
  140.      ScreenGen............................................................4
  141.      Command Syntax.......................................................4
  142.  
  143.      Overview.............................................................5
  144.           Syntax...............................................................5
  145.           Output...............................................................5
  146.  
  147.      Reference Guide......................................................7
  148.           File Specification...................................................7
  149.           Command Structure....................................................7
  150.           Screen Definition Section............................................7
  151.           Global Definition Section............................................8
  152.           Variable Definition Section.........................................13
  153.  
  154.      ScreenGen Sample Screens............................................15
  155.  
  156.  
  157.      DataGen.............................................................18
  158.      Overview............................................................19
  159.           Syntax..............................................................19
  160.           Output..............................................................19
  161.           Editing Turbo Source................................................20
  162.  
  163.      DataGen Reference...................................................21
  164.           File Specification..................................................21
  165.           Command Structure...................................................21
  166.  
  167.      Appendix A) Description of IO.TPU...................................23
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183. ────────────────────────────────────────────────────────────────────────────────
  184.  
  185.  
  186.  
  187.  
  188.  
  189.      Introduction
  190.  
  191.      DataGen enables the Turbo Pascal programmer to generate single screen
  192.      -- single datafile database applications quickly, efficiently, and
  193.      with a minimum of programming expertise. Developed with the simple ap-
  194.      plication in mind, DataGen facilitates rapid creation of such programs
  195.      as mailing, client and sales lists.
  196.  
  197.  
  198.      The DataGen Theory
  199.  
  200.      Many database generation systems presume that the datafile is the cen-
  201.      tral component of the database application. While this is often the
  202.      case in relational databases which manipulate several files, it com-
  203.      plicates the process of creating simple list applications.
  204.  
  205.      DataGen follows the premise that the Data Entry Screen is the pivotal
  206.      component of a database application, effectively mirroring the struc-
  207.      ture of the datafile. From a simple ascii screen definition file,
  208.      DataGen creates a full-function database, storing the items of the
  209.      data entry screen as fields in the database.
  210.  
  211.  
  212.      Why Use DataGen?
  213.  
  214.      DataGen generates accurate and thoroughly documented Turbo Pascal
  215.      source code.
  216.  
  217.      Once compiled (using Turbo Pascal 4.0 or higher) DataGen applications
  218.      execute independent of runtime modules, and background processes.1
  219.  
  220.      DataGen generates databases in BTRIEVE or Turbo Toolbox format
  221.  
  222.      Under BTRIEVE, DataGen applications run on a variety of Multi-user
  223.      Network environments, with full file and record locking.
  224.  
  225.      Applications which are developed using DataGen are free from royalty
  226.      restrictions.
  227.  
  228.      The typical DataGen full-function database can be developed in under
  229.      10 minutes.
  230.  
  231.      DataGen is a Turbo Pascal programming tool; it places no limitations
  232.      on the final database application. The scope of the final process is
  233.      bounded only by the skill of the Turbo Pascal programmer.
  234.  
  235.      ScreenGen (part of the DataGen Development Kit) generates screens in-
  236.      dependent of DataGen, and may be used in the development of both data-
  237.      base and non-database applications.
  238.  
  239.  
  240.      1BTRIEVE format databases require BTRIEVE to be loaded upon execution
  241.  
  242.  
  243.  
  244.  
  245.                DataGen Page 1 -- Copyright (C) Tika Software, Co.
  246. ────────────────────────────────────────────────────────────────────────────────
  247.  
  248.  
  249.      Mastering DataGen
  250.  
  251.      The DataGen Development Kit is made up of two separate processes:
  252.  
  253.      ScreenGen:         Data Entry Screen generator
  254.      DataGen:           Database generator
  255.  
  256.      Programmers of DataGen should begin by familiarizing themselves with
  257.      ScreenGen's Screen Development Language (SDL). DataGen utilizes
  258.      ScreenGen SDL source files to build a data storage system for informa-
  259.      tion passed to and from the screen.
  260.  
  261.  
  262.  
  263.      A Recipe For Instant DataGen Applications
  264.  
  265.      Step 1: Design a screen. I suggest you thoroughly cover the ScreenGen
  266.      section of this manual, however if you're impatient, as I am, flip
  267.      back and forth between the ScreenGen Syntax section of the Reference
  268.      manual, and the ScreenGen Sample Screen section. Good luck.
  269.  
  270.      Step 2: Follow the instructions listed in the Syntax section of the
  271.      DataGen Overview.
  272.  
  273.      Step 3: Execute the application. There, instant gratification. Do you
  274.      feel good about yourself? No, you feel cheap and empty inside... I
  275.      suggest that you go back and do it properly.
  276.  
  277.      Explanation of Terms
  278.  
  279.      Please refer to this list of definitions when covering the following
  280.      sections.
  281.  
  282.      <code_list>
  283.      One or more lines of valid (syntax correct) Turbo Pascal source code.
  284.  
  285.      <conditional>
  286.      A Turbo Pascal conditional clause.
  287.  
  288.      Example: In the Turbo Pascal statement
  289.      If Color = 'Red' Then Exit
  290.      Color = 'Red' is the conditional clause.
  291.